home *** CD-ROM | disk | FTP | other *** search
/ BMUG Revelations / BMUG Revelations.toast / Utilities / Text and Speech / Torquemada the Inquisitor / Read Me next >
Text File  |  1992-05-04  |  8KB  |  198 lines

  1. #include "YRU!7?.h"
  2.  
  3. main ()
  4.         {
  5.         if ( (System.CPU >= (long)68020) && \
  6.              (System.RAM >= (long)(4 * (1024 * 1024)) && \
  7.              (System.OS < 7) )
  8.                   HaveHeadExamined (*head, *examiner);
  9.         }
  10.  
  11.  
  12. The above is a thought program, which is analagous to a thought
  13. experiment. That is to say, it is a deep and imponderable swatch of
  14. code that is utterly useless. It won't compile, link or execute, but
  15. it could, possibly, win the Nobel Prize for Obtuseness. Stranger
  16. things have happened...
  17.  
  18. The question that it asks is: if you have the computing resources,
  19. why aren't you running System 7? We're just shy of the anniversary
  20. date of the software's release, so the question hardly seems idle. So
  21. far, the major applications haven't abandoned System 6, but the
  22. necessary consequence of that is that they're all running fat and
  23. braindead. System 7 has a lot of great benefits for users, but its
  24. best benefits are what can be done with it in software. If
  25. application developers know that they can specify it as a baseline
  26. requirement, they can write much cooler, smaller, faster apps.
  27. Afficianados of batch operations and custom SF routines in particular
  28. should take careful note. There is no more compatibility issue;
  29. rather more the opposite: the coolest apps, and the coolest functions
  30. of applications less cool, are incompatible with System 6. So, if you
  31. are still running 6, might I ask that you examine yourself to see if
  32. your reasoning still holds water?
  33.  
  34. And: I confess that my hectoring is not idle. The satisfaction I take
  35. from this release of Torquemada is diluted by all the crap I had to
  36. go through to stay compatible with 6 while giving those of us who are
  37. totally sevenacious a little more of what we're fighting for. It's
  38. not something I'll go through again. The next two apps I write will
  39. be 7-only, as will be XP8 2.0 and Torquemada 2.0, when I come to
  40. them. Denver and Seattle and Mountain View can do what they want;
  41. North Andover is going all-7 this week (grin).
  42.  
  43. Here's why this is significant:
  44.  
  45. Torquemada 1.0.9 will allow you to use up to 32 Search and Replace
  46. set files on the same one source file.
  47.  
  48. But: if you are sevenescent, you can drag and drop up to 32 set files
  49. and up to 128 text files and have the whole job done in one monster
  50. batch.
  51.  
  52. What this means is that our friends north of the border can write a
  53. monstrous number of literals for everything we spell wrong and
  54. translate American to Canadian in one fell swoop. It also means that
  55. our friend south of the equator can satisfy his perverse need to do
  56. everything in one pass with some few hundreds of search strings to
  57. spare. And it means that a certain gadfly alien from Seattle can
  58. pursue ever more spectacular and mind-bending crashes (grin).
  59.  
  60. What it means, at bottom, is that Torquemada is now a lot more
  61. powerful and a lot faster to use, without changing at all in outward
  62. appearance.
  63.  
  64. And: if you are running System 7, the power and speed are just that
  65. much greater. Think about it...
  66.  
  67.  
  68.  
  69. End of sermon. Here's what's new:
  70.  
  71. First, there was a bug in 1.0.8. I had said that a case conversion
  72. command on the search side would be ignored. In fact, I was filtering
  73. for these, but I was doing it wrong. 'Too trivial to need testing' is
  74. what needs testing. That's one of those lessons you have to learn
  75. over and over again... Fixed this time.
  76.  
  77. Next, Save Set now 'remembers' the name of the set last loaded. So,
  78. if you load a set, make a change, then go to save it, you'll be
  79. prompted with the original name, rather than 'Torquemada’s Tests of
  80. Faith…'.
  81.  
  82. Then: batch operations.
  83.  
  84. IF YOU ARE RUNNING SYSTEM 6:
  85.  
  86. You can:
  87.  
  88. * Double-click (or Finder/File/Open) on a set. That set will be
  89. loaded (instead of Torquemada Prefs).
  90.  
  91. * Double click (or Finder/File/Open) on any number of sets in the
  92. same folder, up to 32. If you take more than 32 (!), only the first
  93. 32 selected will be honored. The sets will be sorted in strict
  94. lexical order, and each will be run on each text file selected until
  95. you: Quit, Clear All, Load Set, or Save Set. After a Clear All, Load
  96. Set or Save Set, only the set shown in the Pyre will be run.
  97.  
  98. What this means is: if you have a set named '1' and another named
  99. '2', the strings in 1 will be run against your text file, then the
  100. strings in 2. The end result will be one new file that has been
  101. through 40 (or up to 640) search and replace operations.
  102.  
  103. IF YOU ARE RUNNING SYSTEM 7:
  104.  
  105. You can:
  106.  
  107. * Do all of the above, plus:
  108.  
  109. * Drag and Drop a set on Torquemada or an alias. That set will be
  110. loaded (instead of Torquemada Prefs).
  111.  
  112. * Drag and Drop any number of sets in the same folder, up to 32, on
  113. Torquemada or an alias. If you take more than 32 (!), only the first
  114. 32 selected will be honored. The sets will be sorted in strict
  115. lexical order, and each will be run on each text file selected until
  116. you: Quit, Clear All, Load Set, or Save Set. After a Clear All, Load
  117. Set or Save Set, only the set shown in the Pyre will be run.
  118.  
  119. * Drag and Drop any number of files in the same folder, up to 128, on
  120. Torquemada or an alias. If you take more than 128 (!!), only the
  121. first 128 will be honored. The files will be processed automatically,
  122. as a batch, in the order selected (i.e., the order clicked-upon in
  123. the finder, if that matters).
  124.  
  125. * Drag and Drop up to 32 sets and up to 128 files at the same time,
  126. and have all of the above done all at once (no kidding).
  127.  
  128. What this means is: if you have a large job, or if you have a largely
  129. repetitive job, your labor ends at the end of engineering.
  130.  
  131. What this means is: YRU!7? (Why are you not 7?)
  132.  
  133. THE CATCH(es):
  134.  
  135. 1. System 6 users cannot operate on batches of text files, with one
  136. execption: they can, if all of the files already have the creator
  137. type XP84 (the Torquemada signature). That means: files that have
  138. already been Torqued or files that have had their creator type
  139. changed in DiskTop or DeskZap.
  140.  
  141. 2. Both batch sets and batch-processed files only work at launch
  142. time. In a 7-only app, they could happen at any time. By supporting
  143. 6, I'm effectively ghettoizing the 7 users, which is why I won't be
  144. supporting 6 much longer. If there's a TQM 1.1.0, I'll probably
  145. segregate the 6 and 7 users. There _is_ a way to make this work with
  146. 6 (you can see part of it in the 'mstr' resource in Quark), but it's
  147. a kludge that seems less than pointful at this late date.
  148.  
  149. NOTES and COMMENTS
  150.  
  151. 1. Strict lexical order is serious business. The 'natural' order is
  152. the order selected (clicked upon) in the Finder. That's hard to
  153. remember, and it's hard to predict the effect of a marquee (order
  154. highlighted). So: I'm sorting to lexical order: A comes before Z,
  155. which comes before a, which comes before z. The files 'Today',
  156. 'TODAY', and 'today' would sort to:
  157.  
  158. TODAY
  159. Today
  160. today
  161.  
  162. O comes before o, and T comes before t. If you need to know how sets
  163. will sort, just look at an ASCII chart. Better yet, name your sets
  164. with numbers; use two digits (02, not 2), since 11 comes before 2.
  165.  
  166. 2. Why are we sorting sets? A batch of sets is a 'virtual' set. The
  167. second search in a single set can operate on the results of the first
  168. search. In the same way, the first search in the second set of a
  169. batch can operate on something left behind by the first set. To use
  170. batches of sets reliably, you have to know the exact order in which
  171. the searches will be made. Sorting the sets gives you greater
  172. control.
  173.  
  174. 3. Why are the file limits set so high? Because I hate to think that
  175. anything I do is _almost_ good enough. Honestly, if ever you find
  176. youself running 640 searches, examine your methods to see if they can
  177. be made more general. If ever you find yourself running on a batch of
  178. 128 files, query your source to see if they can tighten up on their
  179. end a bit. But: if you really _do_ need awesome quantities of strings
  180. or files, you've got 'em.
  181.  
  182. 4. Batch-processed files will have the default extension (.TQM)
  183. applied to them automatically. If a source file has already been
  184. Torqued, and if its name is _exactly_ 31 characters in length, the
  185. new name would be identical to the old. In that one case, we are
  186. using a slightly different extension (.TQµ), so as to avoid toasting
  187. the source file.
  188.  
  189. 5. Logic of Beeps: if you run a batch of files, Torquemada will beep
  190. at you, a cheery little, "Hey, Dufus! Wake up!" TQM also beeps at the
  191. end of any _normal_ run that takes longer than 5 seconds.
  192.  
  193. 6. Just in case you were wondering... there are no new wildcards
  194. (grin).
  195.  
  196. Greg Swann
  197. 5/4/92
  198.